PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Window Manager >

Programming With the Mac OS 8.5 Window Manager

Window Definition Feature Constants

With the Mac OS 8.5 Window Manager, your window definition function may report the following new feature flags to reflect the features that your window supports. For descriptions of the messages that correspond to these feature flags, See Window Definition Message Constants. For other window definition feature flags, see "Defining Your Own Window Definition Function" in Mac OS 8 Window Manager Reference .

enum {
    kWindowSupportsDragHilite           = (1 << 7),
    kWindowSupportsModifiedBit          = (1 << 8),
    kWindowCanDrawInCurrentPort         = (1 << 9),
    kWindowCanSetupProxyDragImage       = (1 << 10).
    kWindowCanMeasureTitle              = (1 << 11),
    kWindowWantsDisposeAtProcessDeath   = (1 << 12)
};

Constant descriptions

kWindowSupportsDragHilite
If the bit specified by this mask is set, the window supports the kWindowMsgDragHilite message.
kWindowSupportsModifiedBit
If the bit specified by this mask is set, the window supports the kWindowMsgModified message.
kWindowCanDrawInCurrentPort
If the bit specified by this mask is set, the window supports the kWindowMsgDrawInCurrentPort message.
kWindowCanSetupProxyDragImage
If the bit specified by this mask is set, the window supports the kWindowMsgSetupProxyDragImage message.
kWindowCanMeasureTitle
If the bit specified by this mask is set, the window supports the kWindowMsgMeasureTitle message.
kWindowWantsDisposeAtProcessDeath
If the bit specified by this mask is set, the window definition function wants to receive a wDispose message for the window if it still exists when the application quits. Previously, the Window Manager would send a wDispose message only if the application explicitly closed the window with calls to the CloseWindow or DisposeWindow functions. The Window Manager would delete a window that still existed when the application called ExitToShell without notifying the window definition function, as part of the destruction of the process. Note that if a window has the kWindowWantsDisposeAtProcessDeath feature bit set, the Window Manager sends your window definition function a wDispose message for the window when the application exits for any cause, including if your application crashes. A window might want to set this feature flag if it allocates data when it is initialized that lives outside of the application heap and that is not automatically disposed when the application quits. The wDispose message is sent very early in the termination process, so it is still safe for the window definition function to call the system back (for example, you may wish to do this in order to dispose of any auxiliary data). However, to ensure compatibility and to create the minimum performance impact, the window definition function should try to do as little as possible after receiving a wDispose message sent during the termination process. For further discussion of the wDispose message, see "Defining Your Own Window Definition Function" in Mac OS 8 Window Manager Reference .
© 1999 Apple Computer, Inc. – (Last Updated 18 March 99)